PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Control Manager >

Programming With the Mac OS 8.5 Control Manager


ControlGetRegionRec

If you implement a custom control definition function, when the Control Manager passes the message kControlMsgGetRegion in your control definition function's message parameter, it also passes a pointer to a structure of type ControlGetRegionRec in the param parameter. Your control definition function is responsible for setting the region field of the ControlGetRegionRec structure to the region that contains the control part which the Control Manager specifies in the part field.

See Control Definition Message Constants for more details on the kControlMsgGetRegion message.

struct ControlGetRegionRec
{
    RgnHandle       region;
    ControlPartCode part;
};
typedef struct ControlGetRegionRec ControlGetRegionRec;
typedef ControlGetRegionRec* ControlGetRegionPtr;

Field descriptions

region
A value of type RgnHandle allocated by the Control Manager. Your control definition function should set this field to the region that contains the control part specified in the part field.
part
A value of type ControlPartCode . The Control Manager passes a constant identifying the control part for which a region is to be obtained. For descriptions of possible values, see Control Part Code Constants .

© 1999 Apple Computer, Inc. — (Last Updated 20 Jan 99)